home *** CD-ROM | disk | FTP | other *** search
/ MacHome 2001 June / MacHome Magazine Demo Disc June 2001.iso / Stuff / Software / Games / MacMAME / MacMAME Read Me First! < prev    next >
Encoding:
Text File  |  2001-01-26  |  10.6 KB  |  158 lines  |  [TEXT/ttxt]

  1. MacMAME 0.37 beta 11
  2.  
  3. WASTE Text Engine © 1993-1999 Marco Piovanelli
  4.  
  5. Ported in alphabetical order by:
  6.  
  7. John Butler (jcbutler@pobox.com)
  8. Aaron Giles (agiles@mame.net)
  9. Brad Oliver (bradman@pobox.com)
  10.  
  11. Special thanks to:
  12.  
  13. Nicola Salmoria (MC6489@mclink.it) and Mirko Buffoni for being the coordinators of the MAME project.
  14. Andrew McCarty (andros@andros.seanet.com),  Carlo Noben, Shane Speck, Raul Silva (raul@silva.com) for the MacMAME icons. Raul also did the "About" box rendering.
  15. Nathan Strum for his MacMAME Info page - http://www.calarts.edu/~nstrum/macmame/
  16. "Steve" at Apple for the fast blitting code in earlier versions.
  17. John Stiles and Richard Bannister for constant programming tips, code donation, & general help and support.
  18. Michael R. Simmons (macguitar@aol.com), beta-tester extraordinaire for finding the bugs.
  19. Y. Nemoto, author of MacMoon for providing competition and general encouragement.
  20. Evan Olcott (eolcott@triplo.com) for the original, non-Appearance front-end code.
  21. Miklos Fazekas for helping bring Voodoo support to OpenGL on the Mac (http://www.mesa3d.org/mac)
  22.  
  23. And to all the Dave's… ;-)
  24.  
  25. David Caldwell (david@indigita.com) for doing MacMultiPac, MAME's predecessor and the Jr. Pac-Man driver
  26. Dave Dries for the extra-cool startup movie.
  27. David Lawrence for his InputSprocket code.
  28. Dave Marli, for his arcade emulator high score page and a ton of other stuff.
  29. David Wareing for the PPC Control Strip hiding code. This code is public domain.
  30. Dave Warker, for finding some bugs in the Mac code that caused crashes under MacOS 8.
  31. Dave Weston (dweston@globaldialog.com) for MAMEbase and a lot more.
  32.  
  33. The official MAME home page is now located at:
  34. http://www.mame.net
  35.  
  36. Thanks go out to everyone for their fine work! The MacMAME homepage can be found at:
  37. http://www.macmame.org
  38.  
  39. There is a German version of MacMAME. It can be found at
  40. http://www.h-o-c.com
  41.  
  42. There is a Swedish version of MacMAME. It can be found at
  43. http://www.emulation.net on the MacMAME page.
  44.  
  45. Registering?
  46.  
  47. This program costs nothing and I expect nothing for it. If you'd like to contribute something, here's a list of things you can do:
  48.  
  49. * Donate $10 (or more!) to your favorite charity. If you do not have one, I do – please contact me for more information.
  50. * send me a postcard
  51. * write a MAME module for your favorite arcade game
  52.  
  53. If you'd like to send me a postcard, my address is:
  54. Brad Oliver
  55. 6800 McNeil Dr. #718
  56. Austin TX 78729
  57.  
  58. If you'd like to send John or Aaron something, please contact them first via e-mail. I love postcards, but more than anything I'd like you to donate something to charity. I cannot stress enough how good it will make you feel to give a little. I used to add people who sent me a postcard to an e-mail notification list, but a stray mouse-click in Outlook not too long ago ended that. ;-)
  59.  
  60. What is MacMAME?
  61.  
  62. In a nutshell, MAME attempts to emulate as closely as possible the original hardware of the early eighties arcade games. As we discover how a game works, support for it is added to the emulator. This is happening at a rapid pace, so be sure to check back often for the latest release of MAME. 
  63.  
  64. To run the games, you need the ROM images, in a package that MacMAME understands. MacMAME looks for ROM files in a folder called "Roms" that resides in the same directory as the application. It currently supports 3 different styles of ROMs - .zip files (common on PC sites), folders with small ROM dumps in them, and the "Super ROM" file which encapsulates the folder ROMs into one file. A program called MAME Converter can be found on the MacMAME homepage (http://www.macmame.org). You can use it to make MacMAME ROM image files from those on the net. Note that you do not need MAME Converter - in fact, I recommend you stick with .zip files as they are easier to use and smaller too.
  65.  
  66. For a complete list of acknowledgements, please check the file 'readme.txt' that is in the Documentation folder -- it contains the instructions, thank-you's and info for the current MAME release.
  67.  
  68. The source code is freely distributed so if you see any bugs or areas of improvement in these modules, please let us know!
  69.  
  70. If you are interested in programming emulations, you must check out the emulation programming repository at: http://www.dct.com/~mhalse/EmuProgramming
  71.  
  72. How do I play MacMAME?
  73.  
  74. You can find the complete documentation on how to use it at this URL:
  75. http://www.macmame.org/help.html
  76.  
  77. Here's a quick breakdown of the keys:
  78.  
  79. 5, 6 - insert a Quarter
  80. 1 & 2 - 1 and 2 player start
  81. ESC - Pause
  82. F - toggle scanline effects for games that support them
  83. F2 - place the machine in "service" mode if it has one
  84. F3 - reset the emulated machine
  85. F4 - show the charsets. Use the arrows to navigate through the various combinations, ESC to return to the game
  86. F6 - If cheats are allowed, this key toggles them on and off
  87. F8 - cycle through frameskip options
  88. F10 - toggle speed throttling (you normally want to leave this on)
  89. F11 - toggle the frames-per-second display on and off
  90. Shift+F11 - toggle run-time profiling
  91. F12 - save a screenshot
  92.  
  93. TAB - access MAME's configuration menu, where you can adjust the keys and dipswitches
  94. Command-` - toggles the on-screen display. You can adjust video and volume sliders here.
  95. Command + Option - temporarily throttle the game to maximum speed.
  96.  
  97. The keys may be configured for each game. Press TAB to get to the configuration menu to change the key settings and also view the key settings for each game. Most games use the arrows to move and control to fire.
  98.  
  99. For best video results, set your screen to it's highest possible resolution. On my Mac, that is 1280x1024. Pick the 3x3 interlaced video mode and the games will really look authentic. Vector games look particularly gorgeous at this high resolution.
  100.  
  101. The interlaced video option only affects 2x2 window sizes that fit entirely onto the screen or when you've hidden the desktop. For best results, use a resolution of 800x600 or higher with the 2x2 option. MacMAME will always force the display to 1x1 if it won't fit on a 640x480 screen, regardless of what you pick. You may switch it back to 2x2 once you've started the game if you really want, but lines will be missing off the bottom of the screen.
  102.  
  103. The 'Sound Samples' folder contains subfolders with samples from games. These are distributed in separate archives, available from my MacMAME page. The proper folder names for the sound samples (for those games that support it) are listed in the file 'gamelist.txt' next to each supported game.
  104.  
  105. Support Files
  106.  
  107. You can use all sorts of optional support files to make your MacMAME experience more pleasant.
  108.  
  109. Nathan Strum's MacMAME info site has a comprehensive list of links to support files:
  110. http://www.calarts.edu/~nstrum/macmame/links/support.html
  111.  
  112. Common Questions
  113.  
  114. Q: When are you slackers going to make it native under MacOS X?
  115. A: A better question is when is MacOS X going to be manly enough to handle MacMAME. :-) A preliminary build is available on the MacMAME homepage, but keep in mind that Carbon and OSX (particularly the Public Beta) have bugs which prevent some of the features from working properly, including keyboard, mouse and joystick input. 
  116.  
  117. Q: I've found some PC ROMs and have downloaded and unzipped them. Will this work?
  118. A: We strongly recommend you use .zip files - just drop them in your ROMs folder. However, do not unzip them. Not only is it unnecessary, it wastes hard drive space.
  119.  
  120. Q: When I start a game, MacMAME tells me that some of the necessary files could not be found. What's wrong?
  121. A: The ROM set you are playing is incomplete. Even if this ROM set worked in a prior version, odds are that it was redumped for the current version of MacMAME, resulting in the error message. The solution is to find a newer ROM set on the 'net.
  122.  
  123. Q: When I start a game, it says that the file "xxx" could not be opened! What's wrong?
  124. A: MacMAME is looking for a specific ROM file for that game but it did not find it. Look around on the net for arcade game ROM archives and you're sure to find the proper files. Some games are harder to find than others though. 
  125.  
  126. Q: I downloaded ROMs for "xxx" but it doesn't show up in the list. What's wrong?
  127. A: Check the file "readme.txt" to see if that game is actually supported. MacMAME won't work with every arcade game - it needs to be written to specifically support games.
  128.  
  129. It's also conceivable you've downloaded a set which is named improperly. To verify the proper name of the ROM set, go to the "Misc" tab in the front-end and save a list of all supported games. It will create a text file with the 8-character .zip file name alongside the game's full name. The only way MacMAME knows which sets are which are by these 8-character names so they must match what MacMAME is looking for.
  130.  
  131. Q: MacMAME says game "xxx" is not supported, but it used to work! What happened?
  132. A: MacMAME needs to know the driver name for each game. It looks for this information either in the ROM file made by MAME Converter or it uses the folder name of the ROM set in the ROMs folder. Most likely, the ROM driver name was changed for the current release so the old name is no longer recognized. The solution is to rename the folder of ROMs and create a new ROM file with MAME Converter - you can find a listing of the driver names in the file "readme.txt" in the Documentation folder.
  133.  
  134. Q: How do I get the sound samples to work?
  135. A: Download the sound samples from the internet and place the .zip file in the Sound Samples folder. This new zip file must match the "driver" name for the game you are playing or MacMAME won't be able to find them. The "driver" names are listed in the file "mamelist.txt" in the Documentation folder.
  136.  
  137. Q: I've downloaded the sound samples, renamed the file properly, but still no sound! What is wrong?
  138. A: MacMAME doesn't support sound samples for every game - check "gamelist.txt" to see which games use sound samples and which don't.
  139.  
  140. Q: Where can I talk about MAME on the internet?
  141. A: Nathan Strum runs a page dedicated solely to MacMAME at:
  142. http://www.calarts.edu/~nstrum/macmame/
  143. He also has set up a message board for MacMAME at
  144. http://www.emuverse.com/boards/forumdisplay.cgi?action=topics&forum=MacMAME&number=18
  145. If Usenet news is your thing, try comp.emulators.misc or alt.emulators.classic-arcade. Additionally, there's a nice, web-based message board dedicated to MAME (all versions) at http://www.mame.net/msg/
  146.  
  147. Wanted:
  148.  
  149. • If you have technical details of how an arcade machine works that you'd like to see, feel free to write a driver for it! We'd be more than happy to include it in the next MAME distribution.
  150.  
  151. • There are a few ROM sets for which ROM dumps are bad. These are marked in the ROM audits. If you have the ability to dump good ROMs for these sets, it would be very much appreciated.
  152.  
  153. Known Mac-specific Issues:
  154.  
  155. • The Carbon builds have various issues.
  156.  
  157. 1/26/01
  158.